package org.jeecg.modules.mes.service;

import com.baomidou.mybatisplus.extension.service.IService;
import org.jeecg.modules.mes.entity.MesProductionPlanOrderDetail;

import java.util.List;
import java.util.Map;

/**
 * @Description: 生产计划订单明细关联服务
 * @Author: jeecg-boot
 * @Date: 2025-08-30
 * @Version: V2.0
 */
public interface IMesProductionPlanOrderDetailService extends IService<MesProductionPlanOrderDetail> {

    /**
     * 根据计划ID获取关联的订单明细
     * @param planId 计划ID
     * @return 订单明细列表
     */
    List<MesProductionPlanOrderDetail> getOrderDetailsByPlanId(String planId);

    /**
     * 根据订单明细ID获取关联的计划
     * @param orderDetailId 订单明细ID
     * @return 计划订单明细关联列表
     */
    List<MesProductionPlanOrderDetail> getPlansByOrderDetailId(String orderDetailId);

    /**
     * 批量创建计划订单明细关联
     * @param planId 计划ID
     * @param orderDetailIds 订单明细ID列表
     * @return 是否成功
     */
    boolean batchCreatePlanOrderDetails(String planId, List<String> orderDetailIds);

    /**
     * 更新订单明细生产进度
     * @param planId 计划ID
     * @param orderDetailId 订单明细ID
     * @param actualQuantity 实际数量
     * @return 是否成功
     */
    boolean updateOrderDetailProgress(String planId, String orderDetailId, Integer actualQuantity);

    /**
     * 获取计划的订单明细统计信息
     * @param planId 计划ID
     * @return 统计信息
     */
    MesProductionPlanOrderDetail getPlanOrderDetailStats(String planId);

    /**
     * 检查订单明细是否可以添加到计划中
     * @param planId 计划ID
     * @param orderDetailIds 订单明细ID列表
     * @return 是否可以添加
     */
    boolean canAddOrderDetailsToPlan(String planId, List<String> orderDetailIds);

    /**
     * 移除计划中的订单明细
     * @param planId 计划ID
     * @param orderDetailIds 订单明细ID列表
     * @return 是否成功
     */
    boolean removeOrderDetailsFromPlan(String planId, List<String> orderDetailIds);

    /**
     * 根据订单明细ID列表获取订单明细信息
     * @param orderDetailIds 订单明细ID列表
     * @return 订单明细Map列表，包含完整的产品和订单信息
     */
    List<Map<String, Object>> getOrderDetailsByIds(List<String> orderDetailIds);
}
